home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / compress / xpack149.zip / XPACK.DOC < prev    next >
PGP Signed Message  |  1996-08-27  |  13KB  |  318 lines
  1. -----BEGIN PGP SIGNED MESSAGE-----
  2.  
  3.  
  4.      XPACK    An Executable and DiskImageFile Compressor (public domain)
  5.  
  6.      Copyright (c) 1995-1996 by JauMing Tseng
  7.  
  8.    WHAT IS XPACK?
  9.  
  10.      XPACK is an EXE/COM/SYS Executable file compressor. This program
  11.      compresses most DOS executable files. Compressed programs use
  12.      less disk space because they are much smaller,
  13.      yet they run EXACTLY as before.
  14.  
  15.      XPACK now allows a compressed diskette image to be created for electronic
  16.      transmission.  The compressed diskette image can be transmitted with the
  17.      use of a modem on regular phone line, or any other electronic networks.
  18.      It can be used to archive diskette images on hard drives or tapes.
  19.      This gaurantees the contents of the diskette to be the same as the
  20.      original -- including all directory structures, date and time stamps of
  21.      all the files and directories.  This is useful for archiving bootable
  22.      diskettes, too.
  23.  
  24.    SYSTEM REQUIREMENTS.
  25.  
  26.      XPACK works on any IBM-compatible machine with 192Kb of free
  27.      DOS memory.
  28.  
  29.      DOS 3.0 or higher is required.
  30.  
  31.      method 4 need extra 192Kb,
  32.      method 5 need extra 147kb for compression
  33.  
  34.      Every file compressed with XPACK can run on any IBM compatible
  35.      system: XT, AT, 80286, 80386, 80486, Pentium or Pentium Pro;
  36.      on Intel and non-Intel.
  37.  
  38.    USING XPACK.
  39.  
  40.      Enter the command:   XPACK [options] filename
  41.  
  42.        where "filename" is the name of the Executable file to be compressed.
  43.        XPACK will only work properly on Executable files, so if you do not
  44.        type a file extension, ".EXE", ".COM" or ".SYS" is assumed.
  45.        The filename can include drive and path specifications
  46.        and wildcards (* or ?).
  47.        The various "options" are explained later.
  48.  
  49.      XPACK will make an Executable file that:
  50.        (a) is smaller than the original, and
  51.        (b) works as before, without any noticeable loss of speed.
  52.  
  53.      The computer may take several seconds to do the compressing. If
  54.      you are impatient you can interrupt the process by pressing the
  55.      ESC key.
  56.  
  57.      Not every .EXE file can be compressed with XPACK.
  58.      (e.g. .EXE with internal overlay packed with option /g)
  59.      That's why this program creates backups. The original FILENAME.EXE file
  60.      is renamed to FILENAME.OLE. If anything goes wrong you can
  61.      restore the original file by entering these 2 commands at
  62.      the DOS prompt:
  63.                       COPY FILENAME.OLE FILENAME.EXE
  64.                       DEL FILENAME.OLE
  65.      (.COM and .SYS files are always packed ok.)
  66.  
  67.    OPTIONS.
  68.  
  69.      Any "options" that you use are typed after "XPACK" and
  70.      before "FILENAME".
  71.  
  72.      Options are all case-insensitive, separated by spaces, and begin
  73.      with either the hyphen ('-') or the slash ('/') character.
  74.  
  75.      Here are the details of the command line options:
  76.  
  77.         -?  This switch invokes option -h
  78.  
  79.         -h  This switch tells XPACK to display a
  80.             Help Screen to the DOS console device.
  81.  
  82.                You can use "XPACK /? > XPACK.HLP" to save it.
  83.  
  84.         -4  This switch tells XPACK to use pack method 4
  85.             best ratio
  86.  
  87.         -5  This switch tells XPACK to use pack method 5 (default)
  88.             2nd compression ratio
  89.             fastest compression
  90.             quickest extraction
  91.             smallest sfx
  92.  
  93.         -x  expand a compressed .COM or .SYS file.
  94.  
  95.         -f  This switch tells XPACK to convert the file even if
  96.             the result is bigger than the original file. (Not many
  97.             users will take advantage of this option!)
  98.  
  99.         -o  This switch tells XPACK to override the default
  100.             generation of FILENAME.OLE backup files. (Use this only
  101.             if you have already determined that XPACK compresses
  102.             the file(s) successfully.)
  103.  
  104.         -g  This tells XPACK to merge an overlay into packed file.
  105.  
  106.              (See note below concerning files that cannot be packed.)
  107.  
  108.                Without the -g option, XPACK does not try to compress
  109.                an .EXE file that contains overlays.
  110.  
  111.              The -g option may not work with every .EXE that contains
  112.              an overlay. It works well with .EXE files compiled from
  113.              text (ASCII) with TURBOTXT (an excellent program that is
  114.              supplied with the registered version of the TURBOBAT
  115.              batch file compiler), overlay programs compiled by
  116.              TURBO/BORLAND Pascal and Clipper 5.2 with Blink 3.0
  117.  
  118.         -pd  Pack files as Data
  119.              those data files can be used by XPACK OnLine Decompression System
  120.              which gives painless access to XPACKed-Data files
  121.              (XPACK OnLine Decompression System is still under alpha-testing,)
  122.              (if you want to do a beta-testing please send a email to:       )
  123.              ("s8203143@simon.pu.edu.tw", thanks                             )
  124.  
  125.         -ud  Unpack XPACKed-Data files
  126.  
  127.    USING XPACK to create compressed diskette image.
  128.    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  129.      Enter the command:   XPACK option drive: filename
  130.  
  131.        where "filename" is the name of the compressed diskette image file.
  132.        If you do not type a file extension, ".XDI" is assumed.
  133.        The filename can include drive and path specifications.
  134.  
  135.      Here are the details of the new options:
  136.  
  137.         -p  Pack the diskette in drive: to filename
  138.  
  139.         -u  Unpack to the diskette in drive: from filename
  140.             the filename here can include wildcards (* or ?).
  141.  
  142.      EXAMPLES.
  143.      ~~~~~~~~~
  144.        To compress all the .EXE files in the current directory
  145.        just type:
  146.                           XPACK *.EXE
  147.  
  148.        To compress without backup all .EXE files in C:\PROGS,
  149.        type:
  150.                           XPACK /O C:\PROGS\*.EXE
  151.  
  152.        To pack all the Executable files using method 4, enter this
  153.        command:
  154.                           XPACK /4 *
  155.  
  156.        To compress BUMF.EXE (made from BUMF.TXT using TURBOTXT),
  157.        enter the command:
  158.                           XPACK -g BUMF
  159.  
  160.        To create a compressed diskette image named MYDISK.XDI in drive B:
  161.        type:
  162.                           XPACK -p b: MYDISK.XDI
  163.  
  164.        To unpack (restore) a compressed diskette image C:\BOOT.XDI in drive A:
  165.        type:
  166.                           XPACK -u a: C:\BOOT
  167.  
  168.        To pack all the files as data in D:\MYDATA
  169.        type:
  170.                           XPACK -Pd d:\mydata\*
  171.  
  172.        To unpack all the XPACKed-Data files in E:\MYDATA
  173.        type:
  174.                           XPACK -Ud e:\mydata\*.*
  175.  
  176.  
  177.      FILES THAT CAN'T BE PACKED.
  178.  
  179.        Some files can't be compressed with XPACK.
  180.  
  181.                - Programs that check the CRC of a file
  182.                - Files that store configuration data internally
  183.                - Drivers that can be loaded in a
  184.                    config.sys file (EMM386.EXE)
  185.                - Some files with "overlays" or DOS4GW overlays, etc..
  186.                    Some "overlaid" files can't be compressed because
  187.                    when you compress such a file the overlay offset
  188.                    changes and the compressed program may not find
  189.                    an overlay.
  190.  
  191.      WINDOWS AND OS/2 FILES.
  192.  
  193.        We cannot Pack Windows or OS/2 New .EXEs are because at the
  194.        ends of these files there are resources, which have to be
  195.        located there.  (e.g. the BITMAPs, Dialogue, Boxes,
  196.        Buttons, and Icons)
  197.          These resources are loaded not with the execution
  198.        of the file, but only when needed by Windows or OS/2.
  199.          Windows and OS/2 files are automatically recognized by
  200.        XPACK.
  201.  
  202.      DISTRIBUTING XPACK.
  203.  
  204.        The XPACK utility is protected by copyright, and may be
  205.        distributed only according to the following limitations:
  206.          1) NO price may be charged, other than a fee for copying
  207.             and mailing the disk.
  208.          2) The utility and documentation must be included together,
  209.             in unmodified form. The XPACK.COM, XPACK.DO